Skip to content

Conversation

bc-terra
Copy link
Collaborator

@bc-terra bc-terra commented Oct 1, 2025

Initial branch creation with relevant guide files.
Base information added to each file.
Guides for Headless and Stencil filled in. Missing screenshots. Other files are placeholders for future content.

DEVDOCS-6497

What changed?

  • Old buyer portal guides are deprecated or obscured in technical structure.
  • New guides set up to go by steps. Content separated by expected structure.

Release notes draft

  • We've created new guides for setting up Buyer Portal covering native Stencil, Headless, and Catalyst deployment with the default build when possible and custom Buyer Portal in any case.

Anything else?

ping { @CNanninga @bigcommerce/dev-docs-team }

Base information added to each file.
Guides for Headless and Stencil filled in. Missing screenshots.
Other files are placeholders for future content.
@bc-terra bc-terra added do not merge Don't merge this work. on hold Work is being place in a hold status. Will need follow up. wip Work is currently in progress. labels Oct 1, 2025
* Building and deploying
* Script config

### Theming Without a Custom Buyer Portal No newline at end of file
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Theming is misspelt; did you mean Teeming? retext-spell retext-spell


See [B2B Buyer Portal Setup Overview](/b2b-edition/docs/buyer-portal) for general prerequisites. You will need a V3 BigCommerce API token with the B2B Edition scope.

See [Local Development](link) for Catalyst prerequisites.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to link is dead no-dead-urls remark-lint


See [B2B Buyer Portal Setup Overview](/b2b-edition/docs/buyer-portal) for general prerequisites. You will need a V3 BigCommerce API token with the B2B Edition scope.

See [Local Development](link) for Catalyst prerequisites.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to unknown file: link missing-file remark-validate-links

The initial deployed preview storefront does not support B2B Buyer Portal features. You must follow the remaining steps and deploy your storefront to your own hosting to enable the Buyer Portal.
</Callout>
2. In the B2B Edition dashboard, navigate to Storefronts and click the ellipsis (...) next to your Catalyst Headless Storefront Channel. Click “Enable B2B” and ensure the channel updates to “B2B Enabled.”
![](screenshot)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to screenshot is dead no-dead-urls remark-lint

The initial deployed preview storefront does not support B2B Buyer Portal features. You must follow the remaining steps and deploy your storefront to your own hosting to enable the Buyer Portal.
</Callout>
2. In the B2B Edition dashboard, navigate to Storefronts and click the ellipsis (...) next to your Catalyst Headless Storefront Channel. Click “Enable B2B” and ensure the channel updates to “B2B Enabled.”
![](screenshot)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to unknown file: screenshot missing-file remark-validate-links

@@ -0,0 +1,133 @@
---
title: Integrate Buyer Portal with Stencil
keywords: buyer portal, b2b edition, open source, stencil

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
b2b is misspelt; did you mean 2b, B2B, bib, bob, bub, BB? retext-spell retext-spell

@@ -0,0 +1,84 @@
---
title: Buyer Portal Overview
keywords: buyer portal, b2b edition, hosted, headless, catalyst

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
b2b is misspelt; did you mean 2b, B2B, bib, bob, bub, BB? retext-spell retext-spell

- [Custom Headless Setup Guide](/b2b-edition/docs/buyer-portal/headless)

## Supported storefront models
- **Stencil:** Embed and control the Buyer Portal via header/footer scripts and theme hooks. See the [Stencil guide](./stencil).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to ./stencil is dead no-dead-urls remark-lint

- [Custom Headless Setup Guide](/b2b-edition/docs/buyer-portal/headless)

## Supported storefront models
- **Stencil:** Embed and control the Buyer Portal via header/footer scripts and theme hooks. See the [Stencil guide](./stencil).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to unknown file: stencil missing-file remark-validate-links


## Supported storefront models
- **Stencil:** Embed and control the Buyer Portal via header/footer scripts and theme hooks. See the [Stencil guide](./stencil).
- **Headless (self-hosted):** Run and deploy the open-source Buyer Portal next to your headless storefront. See the [Headless guide](./headless).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to ./headless is dead no-dead-urls remark-lint


## Supported storefront models
- **Stencil:** Embed and control the Buyer Portal via header/footer scripts and theme hooks. See the [Stencil guide](./stencil).
- **Headless (self-hosted):** Run and deploy the open-source Buyer Portal next to your headless storefront. See the [Headless guide](./headless).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to unknown file: headless missing-file remark-validate-links

## Supported storefront models
- **Stencil:** Embed and control the Buyer Portal via header/footer scripts and theme hooks. See the [Stencil guide](./stencil).
- **Headless (self-hosted):** Run and deploy the open-source Buyer Portal next to your headless storefront. See the [Headless guide](./headless).
- **Catalyst:** Render the Buyer Portal on top of Catalyst and wire authentication. See the [Catalyst guide](/storefront/catalyst/experiments/buyer-portal).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Link to /storefront/catalyst/experiments/buyer-portal is dead no-dead-urls remark-lint

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge Don't merge this work. on hold Work is being place in a hold status. Will need follow up. wip Work is currently in progress.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant